home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / pc / FILEID15.ZIP / FILEID.DOC < prev    next >
Encoding:
Text File  |  1995-01-05  |  6.8 KB  |  200 lines
  1.  
  2. FILEID 1.5 - the documentation
  3. ===============================
  4.  
  5. This is a little program that makes a list of files. The list is an
  6. ASCII file which includes:
  7.  
  8.    - names of the files
  9.    - their sizes in kilobytes and their dates
  10.    - small descriptions of the files
  11.    - descriptions that archives often contain
  12.  
  13. There are other similar programs available, like Zipper, Dizdir and
  14. GetDiz. Zipper has a nice user interface, but the shareware version
  15. has a stupid limit of ten files. But FILEID is not crippleware, and
  16. it's totally free to use! In addition to that, FILEID has the most
  17. features.
  18.  
  19.  
  20.  
  21. REQUIREMENTS
  22. ============
  23.  
  24. The files PKUNZIP.EXE, ARJ.EXE and LHA.EXE must be in a directory
  25. specified with the PATH command. But, of course, if you only use .ZIP
  26. files, you will only need PKUNZIP.EXE, but I think most modem users
  27. have all three programs anyway. 
  28.  
  29. The /H switch, which displays the list immediately after it has been
  30. created, uses the MS-DOS command EDIT. If you use that switch, make
  31. sure EDIT is in your path. If you don't have Edit, you can rename any
  32. file viewing program to EDIT.COM or EDIT.EXE, and put it in your path.
  33.  
  34. By the way, this program doesn't work on a 8086/8088/whatever, but who
  35. cares?
  36.  
  37.  
  38.  
  39. HOW TO USE FILEID
  40. =================
  41.  
  42. It's easy. To run FILEID, you just have to type FILEID at the prompt.
  43. But if you want, you can use some parameters to make the list look the
  44. way you want, like this:
  45.  
  46. FILEID [filenames] [<switch>][<switch>]...
  47.  
  48. [filenames] specifies which files to include in the list. Wildcards
  49. are (of course) supported. If you type the name of a directory here,
  50. all files in that directory will be included in the list. 
  51.  
  52. Examples:
  53. FILEID *.ZIP
  54. FILEID C:\DOWNLOAD   (will include all files in C:\DOWNLOAD directory)
  55. FILEID A:\*.ARJ
  56. FILEID \WAREZ\E*.A0?
  57.  
  58. If you don't specify any [filenames], all files in current directory
  59. will be included in the list.
  60.  
  61.  
  62.  
  63. SWITCHES
  64. ========
  65.  
  66. /L:filename   Specifies what the output file (the list) will be
  67.               called. If you don't specify anything the file will be
  68.               called LISTA.TXT.
  69.               For example, type: FILEID /L:MYFILES.LST
  70.  
  71. /A            If a list already exists, the new list will be appended
  72.               to the existing one. If this switch isn't used, the old
  73.               list will be overwritten.
  74.  
  75. /S            This will include subdirectories of the current
  76.               directory in the list.
  77.  
  78. /O            This will sort the list in alphabetical order. 
  79.  
  80. /D            Only archives containing a description will be included
  81.               in the list.
  82.  
  83. /W:n          Creates listing of your latest wares. This is useful for
  84.               certain BBSes with strict date checking :-) The list
  85.               will only include archives that contain a description,
  86.               whose date is younger than n days. n is a number between
  87.               0 and 365.
  88.  
  89. /1            Use one-liner descriptions. Special characters are
  90.               exluded from the descriptions, which means the list
  91.               won't contain loads of rubbish.
  92.  
  93. /C            If archive doesn't contain any description, the contents
  94.               of the archive will be shown in the list.
  95.               NOTE: This feature has only been tested with the latest
  96.               versions of the archiving software (PKUNZIP 2.0, LHA
  97.               2.55b and ARJ 2.41a). Compability with other versions is
  98.               not guaranteed.
  99.  
  100. /X            This will check if .EXE-files are self-extracting
  101.               archives, and check if they contain descriptions. This
  102.               will usually make the processing slower.
  103.  
  104. /T            As a default, FILEID will only use archive descriptions
  105.               from FILE_ID.DIZ files. Using this switch, FILEID will
  106.               also use descriptions from DESCRIPT.ION, FILE.DES and
  107.               FILE.SDI files.
  108.  
  109. /P            Includes PCBoard color codes in the list. They can
  110.               sometimes be found in FILE_ID.DIZ files.
  111.  
  112. /H            This will show the list immediatly after it has been
  113.               created using EDIT.
  114.  
  115. /?            Shows a short help about these switches.
  116.  
  117. You can use many switches at the same time, in any order. Like this:
  118. FILEID *.ZIP /L:C:\MODEM\FILES.TXT /S /O
  119.  
  120. FILEID can handle up to 100 subdirectories (if you use the /S switch).
  121. The number of files is unlimited, except if you use the /O switch,
  122. when FILEID handles 4000 files per directory. If you have a directory
  123. with more than 100 subdirectories or 4000 files, tell me!
  124.  
  125. If you get tired and want to stop the processing, just press Escape.
  126.  
  127.  
  128.  
  129. SOMETHING ELSE
  130. ==============
  131.  
  132. You can use this program any way you want. I usually have a lot of ZIP
  133. files with cryptical filenames in my downloading directory and on
  134. disks. Using FILEID is an easy way to find out what they really are.
  135. Even if the disk is full or write-protected, you can create the list
  136. by running FILEID A:\*.* from some other drive. You can even use the
  137. same trick on CD-ROMs.
  138.  
  139. FILEID is freeware, which means it's free to use, but the files must
  140. not be changed. If you sell/give/upload this program to anyone/any-
  141. where all files must be included.
  142.  
  143.  
  144.  
  145. HISTORY (very interesting :-)
  146. =============================
  147.  
  148. Version 0.96ß - Initial release
  149.  
  150. Version 1.00:
  151.    - Doesn't display rubbish on screen
  152.    - /S which includes files from all subdirectories
  153.    - Includes all files, not just archives
  154.    - Supports ARJ files called *.A01 or similar
  155.    - Includes name of directory plus total size and number of files
  156.  
  157. Version 1.10
  158.    - /O sorts the list in alphanumeric order
  159.    - /L:filename choses name of output file
  160.    - More information about MOD, STM, S3M, GIF, TXT and DOC files
  161.    - /X searches for FILE_ID.DIZ in self-extracting archives (.EXE)
  162.    - /? displays help
  163.  
  164. Version 1.12ß
  165.    - Does not include PCBoard color codes in the list
  166.    - /P includes the PCBoard color codes
  167.    - You can specify which files to include in the list
  168.    - Information about TDF (TheDraw font) files
  169.  
  170. Version 1.3
  171.    - Fixed a small bug
  172.    - /A appends new list to old one
  173.    - supports DESCRIPT.ION, FILE.DES and FILE.SDI files
  174.    - /H shows the list
  175.    - /1 creates one-liner list
  176.    - /D includes only archives with description
  177.  
  178. Version 1.4
  179.    - Checks if required EXE files can be found
  180.    - /W:n which produces list of n days wares
  181.  
  182. Version 1.5 (this version)
  183.    - Processing can be interrupted by pressing Esc
  184.    - /C lists contents of archives that don't have descriptions
  185.    - Bug fixes
  186.  
  187.  
  188.  
  189. AND THE MOST IMPORTANT PART...
  190. ==============================
  191.  
  192. I'd like any comments, suggestions, ideas and bug reports about this
  193. program. Let's improve FILEID! Leave me a message at Metropoli BBS at
  194. the number +358-(9)0-61500028.
  195. Or send me e-mail at: Janne.Lindberg@umcr.nullnet.fi
  196.  
  197.  
  198.  
  199. Janne Lindberg
  200.